home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / g_quake / newwad12.zip / NEWWAD.TXT < prev    next >
Text File  |  1996-09-18  |  5KB  |  107 lines
  1. NewWad 1.2
  2. (originally pcx2wad by daniel gilliland);
  3. Modified by Christopher Wise
  4.  
  5. NewWad is a program to add textures in pcx, bmp or lbm formats
  6. to the WAD2 files that are used by qbsp.
  7.  
  8. NewWad is my modification to PCX2WAD 0.98 by daniel gilliland.
  9. pcx2wad now performs anti-aliasing on the smaller mipmaps using 
  10. a 2 dimensional sinc function. 
  11.  
  12. Usage:
  13. The command line syntax is:
  14. newwad <scriptfile> <wadfile>
  15.  
  16. <scriptfile> is the full name of the script that newwad reads.
  17. <wadfile> is the full name of the wad file to which the textures 
  18. are to be added. If you specify a wad file name that already 
  19. exists the textures will be added to the file. Your script file 
  20. should contain only the new entries if you are adding to the file.
  21.  
  22. WARNING: MAKE SURE TO BACK UP YOUR WAD FILES AS THIS PROGRAM HAS 
  23. NOT BEEN EXTENSIVELY TESTED AND COMES WITH NO GUARANTEE.
  24.  
  25. If the program exits with an error during the script reading 
  26. process the original wad file should be untouched. However if 
  27. there is an error during the writing procedure the wad file will
  28. be corrupted, so keep a backup copy of your wad file.
  29.  
  30. Scriptfiles:
  31. A script file is just a list of the inupt filenames and the 
  32. corresponding texture name that will be included in the wad file.
  33. The texture name can be up to 16 characters long and can include 
  34. the '*' and '+' characters for animated textures. There should be 
  35. one entry per line. Comments are prefixed by // and can appear after 
  36. an entry or on a separate line.
  37. NewWad supports pcx/bmp/lbm formats but only with 256 colour images 
  38. and dimensions that are a multiple of 16.
  39.  
  40. For example:
  41. ----script.txt-----
  42. tech06_2.pcx    TECH06_2
  43. stairs.lbm      STAIRS
  44. // this is a comment
  45. crate0~1.bmp    CRATE
  46. lava1.pcx    *LAVA1  // this is a comment 
  47. -------------------
  48.  
  49. Running "newwad script.txt wadfile.wad" would do the following:
  50.  
  51. If a file called wadfile.wad does not exist then a file called 
  52. 'wadfile.wad' would be created, and it would contain 4 mip textures: 
  53. TECH06_2, STAIRS, CRATE and *LAVA1. Use these names in .map files to 
  54. specify which texture you want each face to have.  Also files called 
  55. palette.lmp and colormap.lmp would be written to disk. If you are 
  56. using the quake palette you can ignore/delete these files.
  57.  
  58. If a file called wadfile.wad exists then the 4 mip textures would be 
  59. added to the file. Palette.lmp and colormap.lmp would NOT be created.
  60.  
  61.  
  62.  
  63. Palettes.
  64.  
  65. The quake palette consists of 256 indexed colours, numbered from 0 to 255. 
  66. Color 255 is used as a transparency colour. Palette entries 240 to 254 
  67. are used as fullbright colours, that is these colours stay the same 
  68. intensity regardless of the surrounding light level in the game. In quake 
  69. they are used in lights, red sigils etcetera. Color 0 is the transparency 
  70. colour for sky textures. Sky textures are a 256x128 bitmap, the left 
  71. 128x128 portion is the partially transparent part of the sky (fast-moving, 
  72. lower clouds), and the right 128x128 portion is the higher, slow-moving, 
  73. solid cloud texture. Palette index 0 is used for transparency.
  74.  
  75. The sub images only use the first 240 colours unless there is a direct match 
  76. to a fullbright colour  or the transparent colour (palette entry 255). 
  77.  
  78. NewWad now uses the palette from each file that is read. Thus it is 
  79. possible to create a wad2 file with textures based on another palette 
  80. for a total conversion. However, it is still the user's responsibility 
  81. to ensure that the palettes of all the input files are all the same.
  82.  
  83.  
  84. Limitations: 
  85. You can't add a picture that is bigger than 512x256. 
  86.  
  87. The imput image MUST have dimensions that are a multiple of 16 pixels.
  88.  
  89. The program exits if an error is encountered. A valid wad file is only 
  90. created if no errors are encountered so you must fix the error in the 
  91. script file or source images and rerun the program.
  92.  
  93. History: 
  94.  
  95. 0.99 I was going to write a complete utility but then I saw this 
  96. program and it's source and thought 'why reinvent the wheel?'. 
  97. Given that daniel gilliland wrote that he did not intend to update 
  98. the program I decided to do it myself. I had already written the 
  99. decimation routine so I just slotted it into the source and recompiled. 
  100.  
  101. 1.0 I have added the ability to update an existing wad file as well as 
  102. create a new wad file. 
  103.  
  104. Email: Contact me (Christopher Wise) at wise@eng2.eng.monash.edu.au
  105. Feel free to ask questions. I would like feedback if the program doesn't 
  106. work properly. I will try to fix any bugs, time permitting and may add 
  107. new features. I hope this program is of use to level creators.